(' 



APPENDIX 

imageln Device Manager 

The Imageln device manager provides interfaces for enumerating devices, querying properties of 
installed Imageln devices and creating Imageln device objects. The device manager has three 
objects. 

ClmagelnDevMgr is used to: 

• Create an enumerator object, CEnumlmagelnDevInfo 

• Create a device object when given a DevicelD. 

• Display Ul to let a user choose a device object. 

• Display Ul to both choose a device and acquire an image from the chosen device. 
CEnumlmagelnDevInfo is used to: 

• Enumerate all Imageln devices on a system. For each device enumerated, a 
ClmagelnDevlnfo object is returned. 

ClmagelnDevlnfo is used to: 

• Query device information properties from the Imageln device. One of the properties, Device 
ID, can be used by ClmagelnDevMgr to create a device object. 

Device information properties are distinct from normal device properties in that they are read from 

the registry and can be queried without forcing the device object to be created. 

A program using its own methods to select an Imageln device would do the following: 

• Create a ClmagelnDevMgr object 

• Use the UmagelnDevMgr interface to create a CEnumlmagelnDevInfo object 

• Use lEnumlMAGEIN J3EVJNFO interface to create a ClmagelnDevlnfo object for each 
imageln device enumerated. 

• Use IPropertyStorage interface of ClmagelnDevlnfo object to inspect the device information 
properties of each device, save the Device ID property from the desired device. 

• Use the DevicelD property in UmagelnDevMgr interface to create an Imageln device object. 



UmagelnDevMgr Interface 

EnumlmagelnDevlnfo 

HRESULT UmagelnDevMgr: : EnumlmagelnDevlnfo ( 
LONG lFlags, 
IEnumIMAGEINJDEV_INFO** ppIEnum) ; 

EnumlmagelnDevlnfo creates a standard enumerator for ClmagelnDevlnfo objects. The 
enumerator itself is a CEnumlmagelnDevInfo object that has a single interface 
IEnumlMAGE!N_DEVJNFO. Applications can use this API to obtain device information properties 
from available Imageln devices. 

Parameters: 

lFlags Specifies the type of device to enumerate. 

ppIEnum Enumeration interface for CEnumlmagelnDevInfo objects. 
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GetlmagelnDevInfo 

HRESULT IlmagelnDevMgr: : GetlmagelnDevInfo { 

BSTR bstrDevicelD, 
IPropertyStorage** ppIPropStg) ; 

Given a device ID GetlmagelnDevInfo returns an IPropertyStorage interface to ClmagelnDevlnfo 
objects. This API gives applications a quick way to retrieve device information properties from a 
stored device ID. 

Parameters: 

bstrDevicelD, Device ID string returned from device info object. 

ppIPropStg IPropertyStorage interface to ClmagelnDevlnfo objects. 



CreatelmagelnDev 

HRESULT IlmagelnDevMgr: : CreatelmagelnDev ( 

BSTR bstrDevicelD, 
IUnknown** ppDevice) ; 

CreatelmagelnDev creates a device object identified by bstrDevicelD and returns an IUnknown 
interface to the object. The application can use Querylnterface on this IUnknown to access the 
other interfaces on a device. 

Parameters: 

bstrDevicelD Device ID string returned from device info object. 

ppDevice (Unknown interface pointer returned. 



SelectlmagelnDev 

HRESULT IlmagelnDevMgr: : SelectlmagelnDev ( 
LONG lFlags, 
IUnknown** ppDevice) ; 

SelectlmagelnDev displays Ul for the selection of Imageln devices. When the user selects a 
device, the device object is created and an IUnknown interface is returned. The application can 
then use Querylnterface on this IUnknown to access the other interfaces on a device. Returns 
S_FALSE if the user cancels the selection dialog without making a device selection, SJ3K if 
the user makes a device selection or an error value if the method fails. 

Parameters: 

IFIags Operation flags 

ppDevice IUnknown interface pointer returned 
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Getlmage 

HRESULT IlmagelnDevMgr: : Getlmage ( 

LONG lFlags , 

LONG 1 Intent, 

LONG cf Format, 

STGMEDIXJM* pMedium) ; 

Getlmage displays device selection Ul allowing a user to select a device. If the user selects a 
device, a device is created and device Ul is displayed to capture the image. Image data is 
returned in the pMedium structure. Image format and default image capture properties may be 
specified using the (Intent and cfFormat parameters. Returns S_FALSE if the user cancels the 
selection dialog without making a device selection, S_OK if the user makes a device selection and 
the data is transferred or an error value if the method fails. 

Parameters: 

IHags Operation flags 

Untent Intent, default image capture properties 

cfFormat Clipboard format desired by application 

U pMedium Image is returned through this medium. 



m 
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EnumDestinationlnfo 

HRESULT IlmagelnDevMgr: : EnumDestinationlnfo ( 
_ LONG lFlags , 

IUnknown* pDe vi c e , 

I EnumlMAGE INJDE S T_ INFO * * ppIEnum) , 



EnumlmagelnDestlnfo creates a standard enumerator for ClmagelnDestlnfo objects. The 
enumerator itself is a CEnumlmagelnDestlnfo object that has a single interface 
IEnumlMAGEIN_DESTJNFO. Applications can use this API to obtain device destination 
properties from an Imageln device. Destination applications are registered using 
|4 RegisterDestinationApplication. 

Parameters: 

IFIags Enumeration flags. 

pDevice Device object. If null destination applications for all devices are 

enumerated. 

ppIEnum Enumeration interface for CEnumlmagelnDestlnfo objects. 



RegisterDestinationApplication 

HRESULT IlmagelnDevMgr: : RegisterDestinationApplication ( 
LONG lFlags , 

LONG 1 Intent, 

IUnknown* pDevice, 
BSTR bstrEvent, 
B 3 TR b s t r AppName , 

BSTR bstrCommandLine) ; 

This method is called when an application wishes to register as an Imageln destination. 
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Parameters: 



lFlags Registration flags, 

Untent Intent, default image capture properties, 

pDevice Device object If null, destination application is registered for all 

devices. 

bstrEvent Optional event name. 

bstrAppName Friendly name of Application. This name will be displayed to the user 

inUL 

bstrCommandLine Full path to the executable for this application. Additional command 
line arguments may be added to this command. 



UnregisterDestinationAppIication 

HRESTUL IlmagelnDevMgr : :UnregisterDestinationApplication 
LONG lFlags, 
IUnknown* pDevice, 
BSTR bstrAppName) ; 



This method is called when an application that has registered an Imageln destination wishes to be 
uninstalled or no longer known as an Imageln destination 



Parameters: 

lFlags Operation flags. 

pDevice Device object If null, destination application is unregistered for all 

devices. 

bstrAppName Friendly name of Application, used to register application. 



IEnumlMAGEIN_DEV_INFO Interface 

The tEnumlMAGEINJDEVJNFO interface is a standard OLE enumeration interface that supports 
per device enumeration of device information properties. 

Next 

HRESULT IEnumIMAGEINJ)EV_INFO : :Next ( 
ULONG celt, 
IPropertyStorage** rgelt , 
ULONG *pceltFetched) ; 

Next returns an array of IPropertyStorage interfaces to ClmagelnDevlnfo objects. Applications 
can use the returned of IPropertyStorage interfaces to obtain device information properties from 
available Imageln devices. 

Parameters: 

celt Specifies the number of elements requested, 

rgelt Address of an array in which to return the IPropertyStorage interfaces. 

pceltFetched Address of a value that receives a count of the item identifiers actually 
returned in rgelt 
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Skip 

HRESULT IEnumIMAGEIN_DEV_INFO: : Skip (ULONG celt); 

Skip skips device objects in the enumeration. 

Parameters: 

celt Number of items to skip. 

Reset 

HRESULT IEnumIMAGEIN_DEV_INFO : : Reset (void) ; 

Reset sets the enumeration back to the first device. 
Clone 

HRESULT I Enum IMAGE IN_J3EV_INFO : : Clone ( 

IEnumlMAGE IN__DEV__INFO **ppIEnum) ; 

Clone creates another !EnumlMAGEiN_DEVJNFO enumeration object and returns an interface 
pointer to it 

Parameters: 

ppIEnum Address that receives a pointer to the new enumeration object. 



lEnumlMAGEINDESTJNFO Interface 

The lEnumlMAGEINJDESTJNFO interface is a standard OLE enumeration interface that 
supports enumeration of device destination properties. 

Next 

HRESULT IEimrnIMAGEIN_DEST_INFO: -.Next ( 
ULONG celt, 
IPropertyStorage** rgelt, 
ULONG *pceltFetched) ; 

Next returns an array of IPropertyStorage interfaces to ClmageinDestlnfo objects. Applications 
can use the returned of IPropertyStorage interfaces to obtain destination information properties 
from available imagein devices. 

Parameters: 

celt Specifies the number of elements requested, 

rgelt Address of an array in which to return the IPropertyStorage interfaces. 

pceltFetched Address of a value that receives a count of the item identifiers actually 
returned in rgelt 



Skip 

HRESULT IEnutnIMAGEIN_DEST_INFO: : Skip (ULONG celt); 
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Skip skips destination objects in the enumeration. 

Parameters: 

celt Number of items to skip. 



Reset 

HRESULT IEnumIMAGEIN_DEST_INFO : : Reset (void) ; 

Reset sets the enumeration back to the first device. 
Clone 

HRESULT IEnumIMAGEINJDEST_INFO: : Clone ( 

IEnumIMAGBIN_DEST_INFO **ppIEnum) ; 

Clone creates another EnumlMAGEINJDESTJNFO enumeration object and returns an interface 
pointer to it. 

Parameters: 

ppIEnum Address that receives a pointer to the new enumeration object. 



IPropertyStorage Interface 



The IPropertyStorage interface is used to query the device information and destination properties. 
IPropertyStorage is a standard OLE interface and is documented in the OLE Programmers 
Reference. AH device information properties are read only. Any attempt to modify the device 
information properties will result in a failure with access denied. The methods of this interface are: 

HRESULT ReadMultiple (ULONG, const PROPSPEC, PROP VARIANT) ; 

HRESULT WriteMultiple (ULONG, const PROPSPEC, PROPVARIANT, PROPID); 

HRESULT DeleteMultiple (ULONG, const PROPSPEC); 

HRESULT ReadPropertyNames (ULONG, const PROPID, LPOLESTR); 

HRESULT WritePropertyNames (ULONG, const PROPID, LPOLESTR) ; 

HRESULT DeletePropertyNames (ULONG, const PROPID) ; 

HRESULT Commit (DWORD) ; 

HRESULT Revert (void) ; 

HRESULT Enum ( IEnumSTATPROPSTG* * ) ; 

HRESULT SetTimes (FILETIME const *, FILETIME const *, FILET IME const *) ; 
HRESULT SetClass (REFCLSID) ; 
HRESULT Stat (STATPROPSETSTG *) ; 



Device Information Properties 

All Imagein devices support the following basic device information properties: 

Device CLSID - The CLSID of the Imagein server for this device. 

Unique Device ID - A device ID which is unique per physical device. 
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Vendor Description 
Device Description 
Device Type 
Device Port Name 
Device Friendly Name 
Device Icon Resource 
Device Bitmap Resource 
Server Name 



- The device manufactures name, 

- A description of the device. 

- A device type constant: scanner, camera... 

- Name of the port through which the device is connected. 

- A user readable device name. 

- Resource file name and ID. 

- Resource file name and ID. 

- The name of the server where the Imagein server for this 
device is running. 
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Imageln Scanner Device Object 

Imageln device objects support interfaces for querying and setting device properties, displaying 
device Ul and transferring data. Imageln devices are required to support a small number of 
standard interfaces that allow applications to deal with all devices in a common manner and 
transfer data from the devices in a manner that is native to the (COM) application. Device objects 
may also support more specialized interfaces to implement custom functions. Since the 
application has a direct connection to the device object, this architecture does not place any strict 
limits on the interfaces a device object can export. Practically speaking though, applications must 
know about an interface for it to be useful. 



IScan Interface 



ScanDIg 

HRESULT ScanDIg ( 

LONG lFlags , 

LONG 1 Intent) ; 

ScanDIg presents the system or device Ul needed to prepare a device for scanning. If the dialog 
successfully completes, the scan object will be ready to begin data transfer via the IDataObject or 
limageTransfer interfaces. The default image capture properties may be specified using the 
optional llntent parameter. Returns S_FALSE if the user cancels the selection dialog without 
making a device selection, S_OK if the user makes a device selection or an error value if the 
method fails. 

Parameters: 

IFIags Operation flags 

llntent Intent, default image capture properties 



IPropertyStorage Interface 



The standard IPropertyStorage interface is used to query and set all scan device properties. 
IPropertyStorage is a standard OLE interface and is documented in the OLE Programmers 
Reference. The methods of this interface are: 

HRESULT ReadMultiple (ULONG, const PROPSPEC, PROP VARIANT) ; 

HRESULT WriteMultiple (ULONG, const PROPSPEC, PROPVARIANT, PROPID); 

HRESULT DeleteMultiple (ULONG, const PROP SPEC) ; 

HRESULT Re adPropertyNames (ULONG, const PROPID, LPOLESTR); 

HRESULT WritePropertyNames (ULONG, const PROPID, LPOLESTR); 

HRESULT DeletePropertyNames (ULONG, const PROPID); 

HRESULT Commit (DWORD) ; 

HRESULT Revert (void) ; 

HRESULT Enum { IEnumSTATPROPSTG* * ) ; 

HRESULT SetTimes (FILETIME const *, FILETIME const *, FILETIME const *) 
HRESULT SetClass (REFCLSID) ; 
HRESULT Stat (STATPROPSETSTG *) ; 



All Imageln scanner devices support the following basic device properties: 
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Horizontal Resolution 
Vertical Resolution 
Horizontal Scan Start Position 
Vertical Scan Start Position 
Horizontal Scan Extent 
Vertical Scan Extent 
Scan Data Type 
Scan Color Depth 



- The horizontal resolution in DPI. 

- The vertical resolution in DPL 

- The horizontal start position in pixels. 

- The vertical start position in pixels. 

- The width of the scan in pixels. 

- The height of the scan in pixels. 

- A data format specification constant. 

- The number of bits per pixel used to specify color. 



Imageln scan devices may support additional device properties depending on hardware configuration. 



The IDevPropStream interface is used to query/set ail current device properties from/to a named, 
non-volatile, registry based storage. The methods of this interface are: 

ReadDevPropStream 

HRESULT ReadDevPropStream (BSTR bstrName); 

ReadDevPropStream reads a device property stream from the specified value and initializes the 
device with these properties. The properties are per user and per device. 

Parameters: 

bstrName Name of the property stream. 

WriteDevPropStream 

HRESULT WriteDevPropStream (BSTR bstrName); 

WriteDevPropStream writes the current device property stream to the specified value. The 
properties are per user and per device. 

Parameters: 

bstrName Name of the property stream. 

ListDevPropStreams 

HRESULT ListDevPropStreams (BSTR *pbstrName) ; 

ListDevPropStreams lists the device property stream names present in non-volatile storage. The 
list is returned in an allocated BSTR which the application must free using SysFreeString. 

Parameters: 

pbstrName Pointer to receive a list property streams. 



IDevPropStream 



Interface 
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DeleteDevPropStream 

HRESULT DeleteDevPropStream (BSTR bstrName) ; 

DeleteDevPropStream deletes a device property stream from non-volatile storage. 
Parameters: 

bstrName Name of the property stream. 



IDataObject Interface 

The IDataObject interface is a standard OLE data transfer mechanism. This interface is used to provide an 
easy and natural way for applications to transfer data from a scan device. The full IDataObject interface 
description can be found in the OLE2 Programmer's Reference. The methods of this interface are: 



HRESULT GetData (LPFORMATETC, LPSTGMEDIUM); 

HRESULT GetDataHere (LPFORMATETC, LPSTGMEDIUM); 

HRESULT QueryGetData (LPFORMATETC) ; 

HRESULT Get CanonicalFormatEtc (LPFORMATETC , LPFORMATETC) ; 

HRESULT SetData (LPFORMATETC, STGMEDIUM FAR *, BOOL); 

HRESULT EnumFormatEtc (DWORD, LPENUMFORMATETC FAR *) ; 

HRESULT DAdvi s e ( FORMATETC FAR *, DWORD, LPADVISESINK, DWORD 

HRESULT DUnadvise (DWORD) ; 

HRESULT EnumDAdvise (LPENUMSTATDATA FAR *) ; 



FAR *) 



HmageTransfer Interface 

The HmageTransfer is a high performance data transfer interface. This interface uses a shared memory 
window to transfer data from the device object to the application, elirriinating unnecessary data copies 
during marshalling. For Simplicity, this interface uses the same format negotiation method as IDataObject. 
HmageTransfer uses two different mechanisms to transfer data.: 

Banded Transfers 

The device breaks a large image transfer up into smaller transfers, which are performed sequentially into an 
application-specified buffer. 

Data Callback 

The device does a single large transfer, while calling back to the application as the transfer progresses. 



itAIIocateTransferBuffer 

HRESULT itAllocateTransferBuf fer { 
LONG lFlags, 
LONG iSize, 
ULONG hSection, 
ULONG ProcessID) ; 



Allocates a buffer to use for scanning data from the device. The buffer is mapped into the address space of 
both the client and server process. 



Appendix Page 10 



ir ijinr mi inppiii 



ir 



1 1 nil 



Parameters: 
IFIags 
ISize 
hSection 
ProcesslD 



Operation flags. 

Size in bytes of the requested buffer. 
Mapped section handle 
Caller process ID 



itFreeTransferBuffer 

HRESULT itFreeTransferBuffer (void) ; 

Free the buffer created by itAllocateTransferBuffer. This buffer is also freed when the device 
object is destroyed. 



itBeginTransfer 

HRESULT itBeginTransfer ( 
LPFORMATETC 
LONG 

IDataCallback* 



pFormatEtc, 
IFIags, 

pIDataCallback) ; 



Reset a device object context to begin an HmageTransfer. 



Parameters: 

pFormatEtc 
IFIags 

pIDataCallback 



Format specification. 
Operation flags. 

Optional transfer progress notification entry point. 



ItGetlmage 

HRESULT itGet Image ( 
LONG 
LONG* 
LONG* 

Perform an image transfer. 

Parameters: 
IFIags 
pISrcOffset 
pcbWritten 



IFIags , 
plSrcOf f set, 
pcbWritten) ; 



Operation flags. 

Source pointer for transfer. 

Actual number of bytes written during transfer. 



itGetlmageCB 

HRESULT itGet ImageCB (LONG IFIags) ; 

Perform an image transfer using a user specified callback. 

Parameters: 

IFIags Operation flags. 



itEndTransfer 

HRESULT itEndTransfer (LONG IFIags) ; 
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Cleanup a device object context after an image transfer. 

Parameters: 

Flags Operation flags. 

itQueryGetData 

HRESULT itQueryGetData (LPFORMATETC pf e) ; 

Check to see if a device supports a given format in an image transfer. 

Parameters: 

pfe Pointer to the FORMATETC structure defining the format, 

medium, and target device to use for the query. 



itEnumFormatEtc 

HRESULT itEnumFormatEtc ( 
M 1 DWORD dw t 

Q LPENUMFORMATETC* IpEnum) ; 

SB Create a format enumerator. 

Si 

F|f Parameters: 

HI . dw Reserved 

%t IpEnum Indirect pointer to the lEnumFORMATETC interface on the new 

a enumerator object. 



, #5 
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Imageln Camera Device Object 

The Imageln Camera is a hierarchical object. The top-level camera object is used to get basic device 
information and also to get access to individual images or image folders. The CCameraltem object 
represents images and Image folders. 

ICamera Interface 

TakePicture 

HRESULT TakePicture ( ) ; 

The TakePicture method instructs a camera to take a new picture. 



GetCameraRootltem 

HRESULT GetCameraRootltem (ICameraltem** pICameraltem) ; 

This method returns an interface to the root CCameraltem object Using the Icameraltem interface it is 
possible to enumerate all images on the camera. 

Parameters: 

PICameraltem Interface pointer to root camera item 

GetCameraltemByHandle 

HRESULT GetCameraltemByHandle ( 

ULONG u 1 I t emHandl e , 

ICameraltem** pICameraltem) ; 

This method returns an ICameraltem interface to the specified CCameraltem object. A handle for a 
CCameraltem object can only be obtained through the ICameraltem interface. 

Parameters: 

ulItemHandle Handle to camera item, previously returned by Cameraltem 

interface 

pICameraltem Interface pointer to Camera Item specified by handle 

CameraDIg 

HRESULT CameraDIg ( 

LONG iFlags, 

LONG 1 Intent, 

ICameraltem** pICameraltem) ; 



Display the camera UI. UI will select an image on a device and prepare for image transfer. The UI returns a 
ICameraltem interface to a CCameraltem ready for data transfer. IDataObject or UmageTransfer interfaces 
are then used to transfer image data. 
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Parameters: 



Untent 

pICameraltem 



lFlags 



Operational flags 
High level intent 

Interface pointer to Camera Item selected by Dig 



ICameraltem Interface 



A CCameraltem object is created for every image and directory on the camera. This is done to support full 
and flexible hierarchical image storage on cameras. A ICameraltem pointer is returned for each 
CCameraltem object. ICameraltem methods are defined below. 

GetltemType 

HRESULT GetltemType (ULONG *pItemType) ; 

GetltemType returns the type of camera item the object represents. The two types of camera items are: 

1 . ItemTypeFolder - CCameraltem is a folder that may contain other CCameraltems 

2. ItemTypelmage - Ccameraltem is an image. 
Parameters: 

pltemType Item Type returned 

GetltemHandle 

HRESULT GetltemHandle (ULONG *pItemHandle) ; 

Returns a handle to the CCameraltem. This handle can later be used by the ICamera interface to get an 
interface pointer back to this object. 



PItemHandle Item handle returned This handle may be used by the GetCameraltemByHandle 
method of the ICamera interface to obtain an Icameraltem pointer. 

OpenlmagePropertyStorage 

HRESULT OpenlmagePropertyStorage (IPropertyStorage** 
ppIPropertyStorage) ; 

Returns an IPropertyStorage interface to the CCameraltem object. 



EnumChildltems 

HRESULT EnumChildltems (IEnumCameraltem** ppIEnumCameraltem) ; 

Creates a CEnumCameraltem object and returns a IEnumCameraltem interface to it This method only 
works if the camera item is a folder and the folder is not empty, as shown in the figure above. 



Parameters: 



Parameters: 



ppIPropertyStorage 



Returned IPropertyStorage interface pointer. 
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Parameters: 

ppIEnumCameraltem Pointer to iEnumCameraltem interface. 

lEnumCameraltem Interface 

IEnumCameraltem is a standard OLE enumerator interface with the usual four methods Next, Skip, Clone 
and Reset. This enumerator will return an ICameralnterface for each camera item in the current camera 
folder (that was used in the call to EnumChildltems). 

Next 

HRESULT Next ( 

ULONG celt, 
ICameraltem** ppICameraltem, 
ULONG* pceltFetched) ; 

Return an ICameraltem interface for each CCameraltem contained by the current folder. 

Parameters: 

celt number of camera items to get 

ppICameraltem List of iCameraltem interface pointers returned. 
pceltFetched Number of interface pointers returned 

Skip 

HRESULT Skip (ULONG celt) ; 
Skip celt CCameraltem objects. 
Parameters: 

celt Number of Ccameraltem objects to skip 

Reset 

HRESULT Reset (void) ; 
Begin at the first CCameraltem object 
Parameters: None 
Clone 

HRESULT Clone (IEnumCameraltem **pp IEnumCameraltem ); 
Create a new CEnumCameraltem object and return a IEnumCameraltem interface. 
Parameters: 

ppIEnumCameraltem New enumerator created to exactly match this one. 
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Camera Download Manager 

The camera download manager monitors the connection status of camera devices. When a camera device is 
connected to the system, the Download Manager will attempt to immediately download all the images from 
the camera onto the system hard disk. The camera download manager will also maintain a data base of all 
images previously downloaded from a given camera and not download images that are already cached. 

Caching images in this manner has several advantages. 

• Camera image download can be very slow, this cache prevents any image from needing to be 
downloaded more than once. 

• Applications do not need a special API to acquire images from a camera, simply wait for the download 
to complete and load the image from the file system. 

• Images are safely and automatically copied to the file system where they can easily be edited, 
archived, printed or just saved. 

In order for the camera download manager to work effectively, camera events must be detectable. For 
example, it should be easy to detect when a camera is connected or disconnected from the system. This 
should be detectable without loading the entire camera driver. Also any activity performed directly on the 
camera (through camera controls) must be reported to software so an accurate internal model of the state of 
the camera can be kept. 
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Sample Code 

Get an image from an Imageln device. Use the Imageln device manager device selection UI and the device 
image acquisition UI. 

y*************************** *********************** *******^ 
* 

* Get ImageFr omlmage In 
* 

* DESCRIPTION: 

* Use the Imageln device manager to select a device and acquire an 

* image using the device UI. 
* 

* PARAMETERS : 

* pszDIBfileName - Name of the DIB file which contain the image data. 
* 

************************************************* 

HRESULT GetImageFromImageIn(LPOLESTR pszDIBfileName) 
{ 

HRESULT hr; 

I Image InDevMgr *pl ItnagelnDevMgr ; 

// Get Imageln device manager object, 
hr = CoCreateInstance(CLSID_ImageInDevMgr, 
NULL, 

CLSCTX_LOCAL_SERVER , 
I ID_I Image InDevMgr , 
( void* * ) &pl ImagelnDevMgr ) ; 

if (SUCCEEDED (hr) ) { 
STGMEDIUM StgMedium; 

// Fill in the storage medium spec and get the image. 
StgMedium . tymed = TYMED_FILE; 
StgMedium. IpszFileName = pszDIBfileName; 
StgMedium.pUnkForRelease - NULL; 
hr = pIImageInDevMgr->GetImage(0, 

0, 

CFJDIB, 
&StgMedium) ; 

pi ImagelnDevMgr- >Release() ; 

} 

return hr; 

} 
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Enumerate all installed Imageln devices and get the device ID of a specific device: 
* 

* GetDevicelDfromDescription 
* 

* DESCRIPTION: 

* Get the unique device ID of an Itnageln device based on it's description. 
* 

* PARAMETERS: 

* pszDescription - Requested device description, from device info properties. 

* pszDevicelD - Buffer for the returned device ID. 

* cbDevicelDSize - Size of the returned device ID buffer in bytes. 
* 

**********************************^ 

HRESULT GetDevicelDfromDescription { 
LPOLESTR pszDescription, 
LPOLESTR pszDevicelD, 
UINT cchDevicelD) 

{ 

HRESULT hr; 

I ImagelnDevMgr *pllmage InDevMgr ; 

if (pszDevicelD && cchDevicelD) { 
*pszDeviceID = » \0 1 ; 

} 

else { 

return E_INVALIDARG; 

} 

// Get Imageln device manager object, 
hr =" CoCreateInstance(CLSID_ImageInDevMgr, 
NULL, 

CLSCTX_LOCAL_S ERVER , 
I ID_I Image InDevMgr , 
(void**) &pl ImagelnDevMgr) ; 

if (SUCCEEDED (hr) ) { 

I Enum I MAGE I N_D EV_INFO *pIEnumIMAGEIN_DEV_INFO ; 
PROPSPEC PropSpec [1] ; 

PROPVARIANT PropVarDesc [1] , PropVarlD [1] ; 
UINT cbSize; 

// Get an enumerator for the Imageln device information. 

hr - pIImageInDevMgr->EnumImageInDevInfo(0 / &p I EnumlMAGE IN_DEV_INFO ) ; 

if (SUCCEEDED (hr) ) { 

IPropertyStorage *pIPropStg; 

ULONG ul; 

// Enumerate the Imageln devices, getting a IlmagelnDevInf o 
// pointer for each. Use this interface to query the registry 
// based properties for each installed device, 
ul = 1; 

while ((hr = pIEnumIMAGEIN_DEV_INFO->Next (1, 

&pIPropStg, 
&ul)) == S_OK) { 

// Read the device description for the current device. 
PropSpec [0] .ulKind = PRSPEC_PROPID; 
PropSpec [0] .propid = DIPJDEVJDBSC ; 

hr = pIPropStg->ReadMultiple(l, PropSpec, PropVarDesc); 
if (SUCCEEDED (hr) ) { 

// Test for a description match. 

if ( 'wcscmp( PropVarDesc [0] .pwszVal, pszDescription)) { 
// Read the device ID. 
PropSpec [0] .propid » DIP_DEV_ID; 

hr - pIPropStg->ReadMultiple(l, PropSpec, PropVarlD); 
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if (SUCCEEDED (hr) ) { 

wcsncpy(pszDeviceID, PropVarlD [0] .pwszVal, cchDevicelD) ; 
Pr opVariant Clear {PropVar ID) ; 

} 

} 

PropVariantClear (PropVarDesc) ; 

} 

pIPropStg->Release{) ; 
if (*pszDeviceID) { 
break; 

} 

} 

pIEnumIMAGEIN_DEV_INFO->Release () ; 

} 

pIImageInDevMgr->Release {) ; 
if (!*pszDeviceID) { 
hr = E_FAIL; 

} 

return hr; 
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